============================================================================
    Japanese full-text search system Namazu for Windows 2.0.18 document
                                                   -- Archive version--

                    Copyright (C) 2008 AKANEIROSOFTWARE, Tadamasa Teranishi.
============================================================================
                                                   Last modified: 2008.03.20


- 1. Introduction
-----------------

  Windows 95/98/Me/NT/2000/XP/2003 Server/Vista will move and does Japanese
  full-text search system Namazu that development has been advanced to UNIX
  base to this package. 
  Namazu became shape called a joint development by Namazu Project from 
  Version 2.0. 

  When namazu.exe of the x86 edition specifies the index by the argument,
  the wild-card cannot be used.

     O: namazu "*u*" idx11 idx2
     X: namazu "*u*" idx*


  This package is a binary package compiled in the Windows environment. 
  There is no installer in this release so a manual installation is needed.

  The content of the package is updated without a previous notice. 


- 2. Thing necessary besides this archive
-----------------------------------------

  ActivePerl that operates on Windows is necessary. 
  <http://aspn.activestate.com/ASPN/Downloads>
  Twining build 800, and please acquire and install the latest 
  version in the fee counter. 
  (Do not operate in the build 500 fee counter and 600, 1000 fee counters. )
  (Only the x86 edition corresponds. It doesn't correspond to the x64 AMD64 
  edition. )



  When ActivePerl is used, install should do Windows Installer beforehand. 


  Supported operating system
   Windows 2000 Service Pack 3; Windows 2000 Service Pack 4;
   Windows Server 2003;
   Windows XP; Windows XP Service Pack 1; Windows XP Service Pack 2

  <http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=889482fc-5f56-4a38-b838-de776fd4138c>


  Supported operating system Windows 2000; Windows NT

  <http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=4B6140F9-2D36-4977-8FA1-6F8A0F5DCA8F>


  Supported operating system Windows 95; Windows 98; Windows ME

  <http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=CEBBACD8-C094-4255-B702-DE3BB768148F>


- 3. Preparation
----------------

  Please uninstall it when Namazu of an old version is installed. Please 
  reboot a system after it uninstalls it. 

  This archive is defrosted by using winzip etc.

  When msvcr71.dll is not installed in the system, dll\msvcr71.dll is copied 
  onto the system directory. 


0. Microsoft Visual C++ 2005 SP1 Redistributable Package (x86)

  The Microsoft Visual C++ 2005 SP1 Redistributable Package (x86) installs runtime 
  components of Visual C++ Libraries required to run applications developed with 
  Visual C++ on a computer that does not have Visual C++ 2005 installed.

    +---------------------------------------------------------------------+
    | redist\vcredist_x86.exe                                             |
    +---------------------------------------------------------------------+


- 4. Copy of directory
----------------------

  The namazu directory and the kakasi directory obtained by defrosting this 
  archive are copied onto C:\. 


- 5. Installation of PPM
------------------------

  ppm-inst.bat is used and the Perl module used with Namazu for Windows is 
  installed. 
  The Perl module is not included in this package. 
  Please move to the directory that develops this archive, download from the 
  Web server according to the following procedure, and install it. 

  +------------------------------------------------------------------------+
  | C:\> C:                                                                |
  | C:\> cd \nmz2.0.XX.XXX-win32                                           |
  | C:\nmz2.0.XX.XXX-win32> ppm-uninst                                     |
  | C:\nmz2.0.XX.XXX-win32> ppm-inst                                       |
  +------------------------------------------------------------------------+

  Extention PPM packing that brings a part of the Perl module used with the 
  filter besides the Perl module of the minimum requirement together can be 
  installed. 
  The installation of this extention PPM packing is not indispensable. 
  I want to add the module about extention PPM packing in the future. 

  
  C:\> C:                                                               
  C:\> cd \nmz2.0.XX.XXX-win32                                          
  C:\nmz2.0.XX.XXX-win32> ext-uninst                                    
  C:\nmz2.0.XX.XXX-win32> ext-inst                                      
  

  * Proxies
  If you use a proxy server, you might have trouble running PPM.

  A. Set Environment Vars

   [[[ PPM4 ]]]

   [ Windows NT/2000/XP/2003 Server/Vista ]
    From start menu "Control Panel -> System -> Advanced -> 
    Environment VAriables".

    1. Add the setting HTTP_proxy, with your proxy name as the value.
       e.g., "http://proxy:8080" 
    2. If you require a user name and/or password to access your proxy, add
       the settings HTTP_proxy, with your user name and password as the
       respective values.
       e.g., "http_proxy=http://username:password@proxy.example.org:8080"

   [ Windows 95/98/Me ]
    In your AUTOEXEC.BAT file, place the following lines then reboot so the
    changes can take effect.

    1. SET HTTP_proxy=<your proxy server (you must include "http://")>
       e.g., SET HTTP_proxy=http://proxy:8080
    2. If you require a user name and/or password to access your proxy, add
       the settings HTTP_proxy, with your user name and password as the
       respective values.
       e.g., SET HTTP_proxy=http://username:password@proxy.example.org:8080


   [[[ PPM3 ]]]

   Up to three environment variables need to be set.

   [ Windows NT/2000/XP/2003 Server/Vista ]
    From start menu "Control Panel -> System -> Advanced -> 
    Environment VAriables".

    1. Add the setting HTTP_proxy, with your proxy name as the value.
       e.g., "http://proxy:8080" 
    2. If you require a user name and/or password to access your proxy, add
       the settings HTTP_proxy_user and HTTP_proxy_pass, with your user name
       and password as the respective values.

   [ Windows 95/98/Me ]
    In your AUTOEXEC.BAT file, place the following lines then reboot so the
    changes can take effect.

    1. SET HTTP_proxy=<your proxy server (you must include "http://")>
       e.g., SET HTTP_proxy=http://proxy:8080
    2. SET HTTP_proxy_user=<your user name> (if required) 
    3. SET HTTP_proxy_pass=<your password> (if required)


  B. Try using PPM
  With your internet connection active, try using PPM again. 
  Try to install a package.


- 6. About the environment variable setting
-------------------------------------------

 [ Setting of environment variable of Windows NT/2000/XP/2003 Server/Vista ]

  From start menu "Control Panel -> System -> Advanced -> 
  Environment VAriables".
  To the variable value clicking variable PATH of the system environment 
  variable in the place where opened
                  +--------------------------------------------------------+
  Variable name:  | PATH                                                   |
                  +--------------------------------------------------------+
                  +--------------------------------------------------------+
  Variable value: | C:\namazu\bin;                                         |
                  +--------------------------------------------------------+
  Please add to head and click "OK". 

  Refer to environment variable HOME and LANG generally set by UNIX for Namazu. 

  Therefore, these environment variables
                  +--------------------------------------------------------+
  Variable name:  | HOME                                                   |
                  +--------------------------------------------------------+
                  +--------------------------------------------------------+
  Variable value: | C:\namazu                                              |
                  +--------------------------------------------------------+
  Input..click..continue.
                  +--------------------------------------------------------+
  Variable name:  | LANG                                                   |
                  +--------------------------------------------------------+
                  +--------------------------------------------------------+
  Variable value: | C                                                      |
                  +--------------------------------------------------------+
  Input..click.


   namazurc is made from namazurc-sample.win32, and next, drive and full 
  path to namazurc to the variable value with NAMAZURC in an empty 
  column of the variable
                  +--------------------------------------------------------+
  Variable name:  | NAMAZURC                                               |
                  +--------------------------------------------------------+
                  +--------------------------------------------------------+
  Variable value: | C:\namazu\etc\namazu\namazurc                          |
                  +--------------------------------------------------------+
  Input..click.

  mknmzrc is made from mknmzrc-sample.win32, and moreover, drive and 
  full path to mknmzrc to the variable value with MKNMZRC in an empty 
  column of the variable
                  +--------------------------------------------------------+
  Variable name:  | MKNMZRC                                                |
                  +--------------------------------------------------------+
                  +--------------------------------------------------------+
  Variable value: | C:\namazu\etc\namazu\mknmzrc                           |
                  +--------------------------------------------------------+
  Input..click.

  It is necessary to set the directory with the locale data to display a 
  Japanese message and to set NAMAZULOCALEDIR. 
                  +--------------------------------------------------------+
  Variable name:  | NAMAZULOCALEDIR                                        |
                  +--------------------------------------------------------+
                  +--------------------------------------------------------+
  Variable value: | C:\namazu\share\locale                                 |
                  +--------------------------------------------------------+
  Input..click.

  It writes it with a space between words by using kakasi when Japanese data 
  is done with mknmz in indexing. It is necessary to set full path of each 
  dictionary with environment variable KANWADICTPATH and ITAIJIDICTPATH to 
  use kakasi. 
  Therefore, these environment variables
                  +--------------------------------------------------------+
  Variable name:  | KANWADICTPATH                                          |
                  +--------------------------------------------------------+
                  +--------------------------------------------------------+
  Variable value: | C:\kakasi\share\kakasi\kanwadict                       |
                  +--------------------------------------------------------+
  Input..click..continue.
                  +--------------------------------------------------------+
  Variable name:  | ITAIJIDICTPATH                                         |
                  +--------------------------------------------------------+
                  +--------------------------------------------------------+
  Variable value: | C:\kakasi\share\kakasi\itaijidict                      |
                  +--------------------------------------------------------+
  Input..click.

  It is necessary to set environment variable pkgdatadir. 
                  +--------------------------------------------------------+
  Variable name:  | pkgdatadir                                             |
                  +--------------------------------------------------------+
                  +--------------------------------------------------------+
  Variable value: | C:\namazu\share\namazu                                 |
                  +--------------------------------------------------------+
  Input..click.


 [ Setting of environment variable of Windows 95/98/Me ]
  Contents of add-to-autoexec.txt are added to C:\AUTOEXEC.BAT. 
  After C:\AUTOEXEC.BAT is edited, it reboots a system. 


- 7. Initialization
-------------------

 [ Setting of mknmzrc ]
  It copies it from C:\namazu\etc\namazu\mknmzrc-sample.win32. 
  Please edit it after making C:\namazu\etc\namazu\mknmzrc. 

  Please refer to "Setting of mknmzrc" of C:\namazu\share\namazu\doc\en\manual.html
  for details of mknmzrc. 

 [ Setting of namazurc ]
  It copies it from C:\namazu\etc\namazu\namazurc-sample.win32. 
  Please edit it after making C:\namazu\etc\namazu\namazurc. 

  Please refer to "Setting of namazurc" of C:\namazu\share\namazu\doc\en\manual.html
  for details of namazurc. 


- 8. About execution with Web server
------------------------------------

  Please copy namazu.cgi.exe from C:\namazu\libexec onto the directory 
  to be able to execute CGI of Web server. 

  Next, referring to namazurc-sample.win32 of C:\namazu\etc\namazu. 
  Please make namazurc and put it in the same directory as namazu.cgi.exe. 
   # Please note the thing that (period ".") adheres to the head of the 
   # .namazurc file name. 
   # It is possible to make it if it is assumed, 
   # "COPY namazurc-sample.win32 .namazurc" by the Command prompt. 


  There is something from which the environment variable set according to Web 
  server is not succeeded to CGI. 
  Therefore, please set a necessary environment variable by setting Web server. 

  Example) For Apache
    Please set the environment variable to httpd.conf. 

  +------------------------------------------------------------------------+
  | SetEnv NAMAZURC "C:/namazu/etc/namazu/namazurc"                        |
  | SetEnv NAMAZULOCALEDIR "C:/namazu/share/locale"                        |
  +------------------------------------------------------------------------+

    Please set other environment variables if necessary. 


- 9. Confirming the operation
-----------------------------

  Test program (pltests) that confirms the operation like Namazu is included 
  in this archive. Please confirm the operation according to the following 
  procedure. 

  +------------------------------------------------------------------------+
  | C:\> C:                                                                |
  | C:\> cd C:\namazu\pltests                                              |
  | C:\namazu\pltests> perl alltests.pl                                    |
  +------------------------------------------------------------------------+

  It takes a little time to test. 
  It passed the test if displayed, "All XX tests passed". 


- 10. Uninstallation of PPM
---------------------------

  The Perl module used with Namazu for Windows can be uninstalled by using 
  ppm-uninst.bat. 
  Please move to the directory that develops this archive, and uninstall it 
  according to the following procedure. 

  +------------------------------------------------------------------------+
  | C:\> C:                                                                |
  | C:\> cd \nmz2.0.XX.XXX-win32                                           |
  | C:\nmz2.0.XX.XXX-win32> ppm-uninst                                     |
  +------------------------------------------------------------------------+

  Extention PPM packing can be uninstalled by using ext-uninst.bat. 
  Please move to the directory that develops this archive, and uninstall it 
  according to the following procedure. 

  +------------------------------------------------------------------------+
  | C:\> C:                                                                |
  | C:\> cd \nmz2.0.XX.XXX-win32                                           |
  | C:\nmz2.0.XX.XXX-win32> ext-uninst                                     |
  +------------------------------------------------------------------------+


- 11. About the source file
---------------------------

* Namazu Web Page 
It is possible to trace it from <http://www.namazu.org/>. 

* Namazu Source Archvie
It is in <http://www.namazu.org/stable/>. 

* Kakasi Source Archvie
It is in <http://kakasi.namazu.org/stable/>. 


- 12. About the copyright and the reprint
-----------------------------------------

 [ About the copyright ]
  It opens it to the public as a free software according to GPL2(GNU Public 
  Licence version 2). 

  msvcr71.dll is DLL that can distribute made by the Microsoft company. 

  Microsoft Visual C++ 2005 SP1 Redistributable Package (x86) can distribute 
  made by the Microsoft company. 


- 13. Immunity
--------------

  This archive is not guaranteed. When distributing it, any guarantee is not 
  done including a tacit guarantee of a merchantability and a specific, 
  target adaptability. 


============================================================================
                    Copyright (C) 2008 AKANEIROSOFTWARE, Tadamasa Teranishi.
                                               <URI:http://www.akaneiro.jp/>
